Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Application-Defined Functions /

MyCompressCompleteFunction

The sequence grabber component calls your compress-complete function in order to determine whether the current frame-compression operation is complete.

Your compress-complete function must support the following interface:

pascal ComponentResult MyCompressCompleteFunction (SGChannel c,
                                             short bufferNum,
                                             Boolean *done,
                                             SGCompressInfo *ci, 
                                             long refCon);

c

Specifies the reference that identifies the channel for this operation.

bufferNum

Identifies the buffer for this operation. You can obtain information about this buffer by calling the SGGetBufferInfo function, which is described on page 5-98.

done

Contains a pointer to a Boolean value. Your function sets this Boolean value to indicate whether the frame has been completely compressed. Set the Boolean value to true if the compression is complete; set it to false if it is incomplete.

ci

Contains a pointer to a compression information structure (defined by the SGCompressInfo data type). If the compression is complete, your function must completely format this structure with information that is appropriate to the frame just compressed. See "The Compression Information Structure" beginning on page 5-20, for a description of this structure.

refCon

Contains a reference constant value. You can set this value by calling the SGSetChannelRefCon function, which is described on page 5-64.

DESCRIPTION

Once a frame has been completely compressed, you can add it to the movie.

SEE ALSO

Your compress-complete function can use the sequence grabber
component's SGCompressFrameComplete function to support the default behavior. SGCompressFrameComplete is described on page 5-102.

RESULT CODES

cantDoThatInCurrentMode

-9402

Request invalid in current mode

Image Compression Manager errors